home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / src / lib / c / time / RCS / Time_ToAscii.man,v < prev    next >
Text File  |  1990-11-27  |  2KB  |  117 lines
  1. head     1.3;
  2. branch   ;
  3. access   ;
  4. symbols  ;
  5. locks    ; strict;
  6. comment  @@;
  7.  
  8.  
  9. 1.3
  10. date     90.11.27.16.04.18;  author kupfer;  state Exp;
  11. branches ;
  12. next     1.2;
  13.  
  14. 1.2
  15. date     89.10.03.22.04.51;  author jhh;  state Exp;
  16. branches ;
  17. next     1.1;
  18.  
  19. 1.1
  20. date     88.12.30.16.20.43;  author ouster;  state Exp;
  21. branches ;
  22. next     ;
  23.  
  24.  
  25. desc
  26. @@
  27.  
  28.  
  29. 1.3
  30. log
  31. @time.h -> spriteTime.h
  32. @
  33. text
  34. @' $Header: /sprite/src/lib/c/time/RCS/Time_ToAscii.man,v 1.2 89/10/03 22:04:51 jhh Exp Locker: kupfer $ SPRITE (Berkeley)
  35. '
  36. '  ROUGH DRAFT!!!
  37. '
  38. .so \*(]ltmac.sprite
  39. .HS Time_ToAscii lib
  40. .BS
  41. .SH NAME
  42. Time_ToAscii, Time_FromAscii, Time_ToParts, Time_FromParts \- time conversion routines
  43. .SH SYNOPSIS
  44. .nf
  45. \fB#include <spriteTime.h>\fR
  46.  
  47. \fBTime_ToAscii\fR(\fIseconds, isInterval, bufferPtr\fR)
  48.  
  49. \fBTime_FromAscii\fR(\fIbufferPtr, timePtr\fR)
  50.  
  51. \fBTime_ToParts\fR(\fIseconds, isInterval, partsPtr\fR)
  52.  
  53. \fBTime_FromParts\fR(\fIpartsPtr, isInterval, secondsPtr\fR)
  54. .SH ARGUMENTS
  55. .AP int seconds in
  56. A time value in seconds to be converted to Ascii.
  57. .AP Boolean isInterval in
  58. If TRUE, interpret the time as a time interval.
  59. .AP char *bufferPtr out,in
  60. A buffer to hold the converted time.
  61. .AP Time *timePtr out
  62. Buffer to hold a time value  converted from Ascii.
  63. .AP Time_Parts partsPtr in/out
  64. Buffer to contain  the decomposed time values.
  65. .AP int *secondsPtr out
  66. Place to store time value converted from parts.
  67.  
  68. .BE
  69. .SH DESCRIPTION
  70. The \fBTime_ToAscii\fR and \fBTime_FromAscii\fR procedures convert a time value in
  71. seconds to and from Ascii. \fBTime_ToParts\fR converts a time value in seconds into
  72. the year, month, day of year, day of month,m day of week, hours, minutes, 
  73. and seconds. 
  74. \fBTime_FromParts\fR converts a time value from its parts to seconds.
  75. Don't give it a date before January 1, 1970 and make sure that the day
  76. of year corresponds to the month and day of month values.
  77. An interval is the difference between two times.
  78. .SH KEYWORDS
  79. ascii, time
  80. @
  81.  
  82.  
  83. 1.2
  84. log
  85. @Added Time_FromParts
  86. @
  87. text
  88. @d1 1
  89. a1 1
  90. ' $Header: /sprite/src/lib/c/time/RCS/Time_ToAscii.man,v 1.1 88/12/30 16:20:43 ouster Exp Locker: jhh $ SPRITE (Berkeley)
  91. d12 1
  92. a12 1
  93. \fB#include <time.h>\fR
  94. @
  95.  
  96.  
  97. 1.1
  98. log
  99. @Initial revision
  100. @
  101. text
  102. @d1 1
  103. a1 1
  104. ' $Header: Time_ToAscii,v 1.1 86/12/13 12:09:47 andrew Exp $ SPRITE (Berkeley)
  105. d9 1
  106. a9 1
  107. Time_ToAscii, Time_FromAscii, Time_ToParts \- time conversion routines
  108. d19 2
  109. d30 1
  110. a30 1
  111. .AP Time_Parts partsPtr out
  112. d32 3
  113. d40 5
  114. a44 1
  115. and seconds. An interval is the difference between two times.
  116. @
  117.